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‘The matarlal Included In this furctiona| 

specification, Including but not Lim| tag 

to, [nstructi{on tlres ana ooerating 
Speeds |{s for Infarnation ourorses only, 
Aft| sucn materlfal TS sugject ta changa 
wItnout netice, Concaguentiy JEC makes 
mo clalm ang snaj| not oe |laogie for jts 
accuracy, oe ; 


- 


Untess Spec{[fleg otherwise, tne terms 
wRsS x and "HOSKelin I™ply "ROVetLgA", 


INTROQUCTION 


-_RPegqgeweeweqaese @ @ 
eo - : 5 


The RSXa439 1/9 structura Is [rmtended to prov[lcs a fFfliexicte 


cevicee ana functlone {naependent [1/0 capaotlite that can 
Suopert stAandara COP#1ii nerlsherals as wei! as enecial 
Durpese uevicas, rt Is @xmectea that ysers will aevaeajiog 


tnelr Own fpacial nurdose device rand] inn softvara,. ant tke 
PSX [70 Structure has Saeq dasigned to maka finpjermantatian 
of I/0 Service aS clean and Strafght-forwara as noassiciea 
(without jronaralzing system [ntegrity or sfficenrcy) 


Perloneral device support fs on) an [ntoaral part of who 25x 
executive, It [s provided by VYorfvlilegad Taces" caljed [7c 
Randler Tasks, wh{cn may bo deveicned of Seater os wityaut an 
Intimates «knowlege of the executive coda, 


1/0 renquests are jade to fogfcal [/9 un|]ts, and aro “arcped 
Into onysical devi[cemun{t references via a set cf “savfcu 
assfgnments", Each Tas«K yas [tS own Set of assidn@ants: and 
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tney. may pe cnanged a[ther by the. TasK |[n. execution, or fron 
tha operator’s console TTY)4 4 


‘An I/D request |s made by Instructing the systom (vla Systen 
Ojrect{[ve) to queue an 1/70 request for an Indjcated LUN 
(Logtoal un|[t Mumoer), FIf the LUN Is ass["ned to a pnysical 
un~Tt, and If the Handliaf Task to supoort that ynlt jis ~menory 
fesidant and [n{tiallzep, the request Is queyed by orlority 
usually the reqyestifAi TasK!s priority) in a Fequest Tist 
‘for tne Ind[cated physical unit, ‘ 


ot attempt t9 ‘%Interoret the the 

Fequest, [t anliy nasises [t to an {[/0 dandler Tas« per LUN 
assignments, and tne dispositior af tha request |s a function 
of tye Handjer Task (not the execgrive), . 


~The RSX exacutlve does 


Whan an-t/0 paquost Tis auyeued for a Task, control] is 
Fstueneq [mmed{ately contingent upon Tas« orlority, of 
~—caurse) to the pequestiina Task, and tnat Task always nas the 

option of suspending! sxecution yntl! completion of an [7/0 
“Fequest, oF operating asynchronously, 


1/9 cotmplet{on may be Iincleated Tn any of three ootianal 
forms, (1). An Event Flag ay be speciflad to ba sat 
(acconcan|ed py a deciqration of a Slarifleant Event) at 1/0 
completion, Task exdcutlon may be Suspended (using the 
-WATTFO® Ajsectiva) untEl an Indleatad Event Finds or |ogteal 
~Comofnas{on of Eventi Flags, Is set,f13  ¢2) An 1/0 status 
Word may eq speac([fifa t2 De sat At cortpleti{an nf an 
Operation, Tris word may oe cleared before sueuelng a 
-Feauest, ang then enecked parlosf[cally, (3) a System Trap. 
Service peutine nay {oe |ncuvoeg [NA a- Task whlen wlil 
Interrupt tne Task’s execution uson 1/5 completion, 


DEVICE [NGEPENDENCE. 


Pees vawtenwnerwnew=ses 


1/9 Prpequests ara made to LOGICAL unm ts, ei1(¢e5 are 
equivalenced to PHYSICAL devicewunits via a "Lotical !inIit 
Table" (Lut), Logical Units are represented oy Lettcal 'init 
Mumoers (LUNS), and eacr LUN |S reoresenten oy an entry Tn a 
"Cogfcail (Unit Table” (LUT), Physi|cal aavicesunits are 
Fenresenteac pony eéntrles Im a tabje called the Poysi[cal linit 
Directory (PUD), . | 


. s ° . . 
Seqesraeranavecun 
‘ : sa 


Ci} Tne WalTFOR Oleectiya srovides an “OQR" comalnatlons ‘and 
a serles of WAITFORS provides an ‘tAND", 
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Tna loaleal/onysical enulvajences are mada by "“ASSIGNIng 
LUNS to onvsica| dav{ce-un|[ts, 


When a LUN Ts aSs]qned to ai apnysf[eal devicewunit, the 
corasponi{[ng LUT entry (sjot) [s set to the address of tha 
corresmonding Put entry, 


Whan a LUN, Ts deasslaned {assfaned te NONE), tre 
corresnonding LUT sjot IS zeroed, 


EFaen Task Has [ts awn Logical Unft Taole wr]ien [s a part af 
tne TasKk‘s disk [mage that Js bhrauaht Into memory wherever a 
Task |S FIXED or whenaver a noreFI] XEN Task [Sf run, Howaver, 
a Task‘s LUT Is not witn([n Tts al etual aaivpess Space, ‘nan 
an 1/0 request {s a (vja tha QUEUE I/O Girective)d tre 
Fequest[ng tasx!s LUT ([N memory) Ts uSed to Gaetarringa which 
physf[oal dayiceeyn{it js to perforn the request, and contents 
Of amy ather LUT Is Trrevelant, ~ | 


Tnere are four mechanisms fn 8SXet1i0 [n wale tna sajectlan 
Of a PHYSICAL 1/9 daviceeun|t can be alterea, They are as 
fojjows, 


INSTALL #- “nan a Task [5 INSTALLea (mee ae 3atcn) 
[nto a svsten, tne number of LUNS any tna 
ass[gnment of each Nay be snecifrleaa, Asstanmants 
to deviceeun|ts without resfaent Manaler Ta3ss AF 
NOT flaggeo, 


REASSIGN se This “CR Function allows a Taskfs alsk 
pes}Tdent assTannments to bea snanted, Assiansents 
to devi[cesunits witnroyt pasf{dent tianaler Tas«s ARF 
flagged, 


ASSIGN «= This Directive allows a Task to charge 
[ts ‘enory fpesfuant LUN assignments, Assigrtents 
to dev[cerun{ts witnout resfqent HWanaler TasKs ARE 


flagged, 

REDIRECT == This “CR Function aljows ALL requests 
of an [nafeatad PHYSICAL caviceeurin to ba 
redilracted to anotrar PHYSICAL cevicerurit, This 
Functlon 1s Intended to serve {in case of 


parioreral fallures arg soas pot nrovid? nortaily 
useful devjca |ndesendence becaysea tne redirection 
[Ss Indenencant of Task ef LUN, 


A Task’s LUN assignments may aa made voth before and during 


execution, Presavecution asslanments ay be wade fron the 
MGR €or Satoh) tersinal, ana runmet{[me assfannents meiy ke 
made from tna executing Task, However, excert for the 


REQYTRECT MCR Fyunctlons, there [s no means of eaxtarnally 
changing the 1/0 devicerunits used oy a TasK uncer 
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execution, 


1/Q REQUESTS 


eaqnmpewaeevwaea @ 
= ad 4 me . 


1/0 regquasts are tade Dy Tasks us[ng elther the “QUEUE [70 
PER TASK ASSTG*MENT OURECTIVE", of tre “GUeile [70 PFR MCR 
ASSIGNYENT OIRECTIVE", Tnese dlrectives are |dantisai 
@xceot for tha LUN assidnments used te tar tna logical unit 
Into a phys[cal unf{t, Tre former uses thea Task!’s own Lut, 
and ttre latter (us2?d tq cammunicute wi[tn tna console 
Operator) uses the MCR Dispatch Taskés LUT, ; 


Wnen a QUcIIE 1/0 Dlrastive [s Issued, a cneck Is made to 596 
Tf the J/0 prenuest can be qyeuedt2)], If |t cannot, che 
Ofrpectiva Status dard (requester’s virtual zero) IS set 
Negative to Indicate rejection, and the negative vaiue 
Indicates the caysea for relectior, If the OVEUE i738 
Nlreect]va Is accented, a request node !s formed anid Inseries 
Into tre the aeylcerun!|t’s request queue, tne tiangler Tasx, 
Tf Idle, |s tertagersd Into service, ard tne requestar’s 
Of[rectiye Status word is set positive (+1) toa Indicate 
peformance of tne <JGIRECTIVE, An Event Flag and an ]/3 
Status olock may de snecifled ta be set uprsan ceon,tetion 
Cd] spos|[tion) of tke [1/0 raquast, 


Tnene [Ss a Separate 1/2 request cueue for esacn pohvstcal 
devicesun{t, Trese@ queues are deques {tn thelr | [stneacs 
In the P'!) antry for tha corresdonding anysical devicaeunit, 
1/0 requests ara cunued oy orlor{ty with tre rlsheost 
‘prlorpi|ty request at tne frent of the aeque, Rera~uests cf 
equal prjorftv are Inserteaq In tna order In wnicaA che 
Fequests afe made, | , 


Tne QUEUE I/% ODyYrectives are Indlcated by “ Directive 
Ident|ficat{[on Codas (31Cs) “7L" (for quete ner Tas<’s 
assign-ents) ang "45" Cfor qgueve car ACK aSsIignrionts), vith 
a Glrectiva Parameter Fiock (OP8) of tra following fornrat: 


re 


C2) Tnere are several reisons why an 1/0 request carnot re 
Queued? (4) tne Indlcated LUN does not exist, (2) tne Lut! Is 
Not assigqn&g ts a nhysicajl unflt, (3) a Hantier Tasx to 
Service the onysical device {5 not rpeslaont, (4) the 
cond|tions for gquauf[ng soec]{fjed ware “ot net, or (5) a node 
for tne racuest aueue |S not avaljaole, 
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Wd, OF -= OLC (34 or 23) § CEFN], 

Wd, 21 -= 1/0 Function code, 

Wd, 22 -= LUN & Caoueutna conal[tfons), 
Wd, G3 == CPryJor{ty] & Unused Bytes, 
Wd, 94 == CAddress of [/0 Status Flock], 
Wd, 99 == Parameter #1, 

WO, J == Parameter ae, 

Wd, 07 == Parameter #3, 

WO, 19 == Paramater #4, 

Wd, 11 <= Parameter #5, 

Wd, Le e= Parameter #5, 

Wd, 13 «© Parameter #7, 


The GUEUE 1/0 Olrect{ves are deserlseq In tna RSX=119 
"QURECTIVES SPEC", 


I/O FUNCTION CODES 


Vege arwretaenwwenwae 
- ; 
. s 


HnTle the exacutive does not Intareret Function Codas, It 
doas recoanfze the low order tnreae do] ts of ALL Ive Fucntian 
Codes as the following "Function atricutess 


Bited ©= No Return function, 
Blt=1 #= passryed, 
Bl t-2 =~ reserved, 


A NO Peturn”™ function IS ane [n whicn ne StAtUS of data fs 
returned £12 tns renuastor, In these cises, 2 TaSk may dueve 
Fequests any EXIT hefore thelr conmpleticen witnout Invoking 
1/0 Rungown, | 


Tne foljowing Is a |Tst of [/5 FunctlIom Codes rastotnizea »y 


cormon nandjer Tasks, [Ut Is not a comofeta ist af Function 
Codes (Any Handler Task may recoanize any function sare 
desired vy Tts Imnlananter) But rather « list ef cades usa 


where daviced Indanendcense {s feas{ole and practicaa, 


BEO432 ARITE LOGICAL RECGRO (LINE) 
@VG401 PRINT FILE 

291739 READ LUGICAL PECCRO (LINED 
OM1T¢L READ UiTADUT ECHO (TTY) 
BP14p" ATTACH UNIT TO TASK 

BR25G BECTACH UNIT FROM TASK 
25924609 ALLOCATE SISK STORAGE 
BIS*G7 OEALLOICATE OFSK STORAGE 
OCG457 TRANSFER TN 

293431 LOAD TASK [MASE oe 

-CA4459 TRANSFER OUT 

BlU4reL RECORD TASK [MAGE #5 
644% OPEN FILE FOR J[NPUT 

CESCHPS OPEN FILE FOR OUTPUT 
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“9@540% CLOSE FILE 
G?6%792 DELETE FILE 
@76422 RENAME FILE 


#% Executive functions perforted cy disk ariver(s) 
on|y for executive, : 


1/0 STATUS BLOCK 


: 9 v 
wVreqg @eaqgeaeataaeseaa 
es, ~ . 225. 4 ca 


‘When 170 comoletion status [s des{red, the address of an [se 
(“Status 8)ock Ts Included In the Queue [70 BPs, Th]s Status 
Block consists of two words of the following format) 


Wd, 2% e- Status Value &@ Unused Byte, 
Wd, @4 e= Lanath of transfer Cin bytes) for 
' READ/SWRITE functions, ana device? 
depandent jn aj! otnesr cases, 


Tne following [s a |[st of common|y returned J/0 status 
Values, Al] passibla Status values returned for a4 
Particular aevice, are c3serfoad In the #SX Spec for tke 
Handilor Task that servicas |t, | 


A positive vajuae ITmnjfes successful cansijetior, and a 
Negative value |nplles rejection of fallur2?, Tha osositive 
Value returned JS WSyally ene (+1), However otneapr ocsitiva 
“Values mav be uSéd, viZe, TTY Hanal3ar Tas«K |Jdentifles cy a 


“AM terminati{[on on Inout, and *U & eS termination on sutaut, 


099 UNRECOGNIZED FUNCTION 
“12 INVALIG aAnNoress 
«20 INVALTO PARANFETERCS) 


a3 UNIT ALREADY ATTACHED 


QUEUING MECHANISM 


Vee qgeaneanaevaewwg Beeaneaewawv & 
~ Ma ee 4 


whan an [7/7 request [TS Quaued for a LUN, a request nats ITs 
formaq ani fnsertad sv orlority [n tne reauast I]st for the 
devicesunjt to whieh the LIN Is assiqnea, Tre forrnat af the 
Fequest node Is as follovs 


Ad, 09 <9 Forward |Tnkaqe, 

Nd, 24 == Backward |[nkag*, 

Wd, 02 #* STO adcress (Task 19), 

Wd, 03 e2 ATL noge adr of requestor, 
Wd, 04 #7 Prfority & Unysea Svta 

dd, 95 2" LUN &@ EFN, © 

Wd, 26 <« [70 Functlan “ode, 

Wd, 07 2" I/0 Status @locx address, 
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-Wd, 1A = Parameter #1) 
Wd, ii =" Parameter #2, 
Wd, 12 «= Poramater #3, 
Wd, 13 =" Parameter #4, 
Wd, 34 o= Prrameter #5. 
wd, 15 2° Parametar #4, 
ad, 16 == Parameter #7, 


After a renuast node [nm Inserted [mn a tdevijcesun[(tfs frequest 
—Ttst, the four foflowlna opoerations cause. of afde thre 

Pracessi[ ng of ths 1/08 pequestt (4) the Hanc|[ sr Task’s Event 
Flag One {[{s Set, (2) an "J/U Requests Sueuaa Counter” Cfor 
tna unit) Is Ineremanted, (3) an “ITfd Reauasts PandAing 
Count" (for the requesting Task) {s j 9srementagsf3] and 44)- 
a S{aoniflcant Evant Ts oeclaped . 


Anan an 1/9 Handier Task js fdjle.e. {t ITssuss a WAITEOR 
Ofréctive w+[th Event Flag one soeciffed as an Cusuallys the) 
Evant Flag whose Satting srould cause Pesutotilon of Handrjer 
TasK execution, Thus, an Idle Hanejes Task Js trjagereg 
Into servi{ca by the aveing an [40 request for any of the 
Units [t services, 


The 179 Rereausts Queyead Counter Ts a word In tre "UN entry 
Of the un[t for wafch thea retuest was cueues, THls count Is 
Inerementes for every request that js tueued for the unit, 
and IS prtvided for Hantjer Task ysas?, “ost Hand|ar tas*s 
GQ not use {t, but Some grecia}l puryosa anc “ultleuntt 
Handler Tasks can onserate more affleertiy wits tals 
- facili{[ty, The count may o# ajteped by tne Handjar Task at 
any time, 


-Tne "370 neguasts Pendinad Yount" [s a word [nm the ATL note 


of eyery active Tas, TAIs ceunt Is Inerenantad anc 
decrenanted to provide an Indication of pand| ns T/C 
Fequasts, This fs uses t0 delay the freojng of Task’s 


memory [f [t EXITs of |S aborted wjtn unsat{sfled [70 
Fenuasts, : 


Quauln’ an 1/0 pequyest {s 2a SIisnlfleant Evant because It Is 
a poss{[hi¢@ cause for Task ewltontng Crasynation of Handajer 
Task when It Is of a RAildner orforlty tain tore requestor 
Task), Trarafors, aA Slanjficant Event Yeolaratjon [5S sare 
whaneyer an !/0 fecuast Is queued, 


° nf . 
Panvvetvuvwenweuune 
ad ‘ ~ oe te 


C3) If a "go Raturn” function, Requests PandiIng count Is NAT 
Tnerenantes, 
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HANDLER TASKS 


Saquvenanetae 
agi ‘ ~ 


Under RSX=119, 1/3 js supported hy "prilv[|ageda Tasks" caljeca 
1g Hand|er TasKs,€4) These Tasks are calles erlvileyed 
besaysa tney nave accyss to (1) tne PPPel1 Exterral Page, 
(2) tho executivefs I|lsts and tables, and ¢3) poutines whase 
misuse coujd |ntarfere witn normal systen yperpation, 
PriIvijaged Tasks are trusteq not to eee ane system under 
whton thay run, . 


‘Tso Handlar Tass consists of two seek lens (1) A “Task 
Yevel", ard (2) an "[nterrupt service routine", Tha Task 
Teve| oortlon of an !/C Hangler Task runS aS a normal Task, 
with jts own context, and In a Software preleity 
multiproaramaing anvironnent, Th[s nart of a randjer Task 
general|y Intarfacas wlth the executive (vlz, ‘enueues 
Fequests) ani oerforms the opulk of tne I[/0 service, The 
Interrupt service routine part of a Hand|er Task runs aer 
Wapdwars prlerity ¢asynciranous to the softwara orlority 
multlprogramning system) In resnonse to a perloharal davice 
Tntersunt, Interrupt service rout{[nes run |n aie onasition 
Independent enyironment, and ganeraliy de as j|ittia as 
possfole, ; 


Handler Task names are dictated by conventios so teat thelr 
memory raS{[dencsy may ba conventently contrajlei, Tae name 
of an 1/0 Handler Task always consists of a two character 
-Symbo| fe oderleneral nave followea ov four g2ts (nperlods), 
Yize» Tana vandler Task that suaports OTe thru OTN Js callec 
"OTe : 


Aly] Han|[der Tasks (at least afj|-tnat contaln [nterrunt 
Servics routines) snould not ba aeclares “checkno{ntanje" 
when they ara INSTALL2@qd Into a systam, Ajso, 795t Handler 
Tasks use their Inlt]Tallzatlon code for Stack stcrage ¢toaee, 
and therefore snould of declareq “Nor Flxaole" wien 
INSTALLEed, 


Handler Tasx restd2ancy [Ss contro||eq py the foljlowina AER 
Functions, 


LGAD -= This “CR Funct{[on allows an onerator te 
cause ]/0 Handilar Tasks to become ready to Serpvica 
1/0 raquests, Handier Tasks are. [ndicatad- ov 
spec|fylng symoolle parloheral Naves (vi[lZas 
OT,I.P,CD), A pastition and/or priorlty nay also 


~ 


SFaeuvnaeunaenraraven 
i 2 é 


C4] The.systea disk driver |s a part of the executive 
assembly, Sut appcars as an 1/0 Handler Task, 
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be speciffed, If a Handjer Task cannot os loaded, 
“a Fessction message [s outpyt, - 


UNLOAD »* This MCR Functien aljowsS an onerator toa 
cause an 1/0 Handjer Tasx to c2ase to service 
raquasts when Jts raquest aueue(sS) are anpty, 
This, of course, frees up menory, 


Wnan a Handler Task 1s Joaded, [t Initlal{zes |tsajf ara 
Instructs the system (WAITFGOR Cirective) to susvend Its 
exaoution until an 170 request jis queued for tye Handler 
Tas, 


q 


1/9 Handler Tasks afe suopif{marteg by two Sats af eamory 
Fes[dent reeentrant subrout|nas: (1) a Handjer Task Ilorarpy, 
and ¢€2) tne Systenr Syoroutines, 


Tna Handler Litrary [s craated Cor not created) at systen 
configuration (SSEN), and providas routines that are ao nnan 
to the more sofisticatea [4/0 servica, viz,e f!l2 structure 
~—blocking/unblocking, access Mmuthods;, atc, Tre kandijer 
Library Tust ° 9A renvantrart,  bdut not necesslairiy 
pos{[tilon=[{[ndapendent’ 


Tha System Suoroutines are a part of the executive asseanhfy, 
and = oaAjwayvs exist, These syudFoutines orovide sastc 
furct[cns, most of whieh ate cannon to all friandi|er Tasas 
Views Gequaue an [/0 fracuest nosa, retiirn a Node to tne rG0 
(of avai[iatie jist elemarts, ete, Tre use of Syst 
Subroutines by Handler Tasks is sescrl[ned later, 


n 


Yy 


Wnan a "orlyfiegsd Task" fs INSTALLed [nto a syste, the ASA 
contents for al| but the Task cote ars datermined ara 
—fecopded with ths Tasxts disk Image, The ennterts of the 
ASR used for Task codes [3 tat ty the exocutive whan tae Tack 
Is loaded (oecayss tne real auntress sprce [nn -whfen It fs 
loaded Is mot fixed), The followlyg [s a description of the 
Vietual address ‘space aijacatfons (ASW usage) for Js/8 
Hand|ler Task jeyel cove, 


Virtua] jocatfons 329929"917777 ¢CASaA™) are used 
for Task lave] code, Note, thls code {s ljm|tad 
to 4K, 

Virtual Jocatfons 2230299977777 (458s 1,02,3) are 


used for exacut{on cof Hangloar LloOrarv routinas, 
Note, the sanajer Liorary [s |[Jajted to led, 


Virtua] locations 193¢58*157777 (ASRs 4,5,6) are 
uSed to accass tha exsetuti[va’s tacies, Jists, ia4 
Syste™ Subroutines, Sota ee the system |ists, 
tables, pools and System Subroutines cannot 
exceede 12x, 
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Virtual locatfons 269990=177777 (AS87). ara used to 
access the POPsii External Page, 


WhTle Interrupt service roytines are orysical|[y a part of 
1/Q Handjer Tasks (usually a part of the same asserdly), 
‘they are executed Jn Kernel mode, and under: the kerne|/s 
ASRS, Thus,  [ntarruct service rout|res are written as 
Pos|[t[on=|]Ndepandent codes (or written to run |n virtual 
address spaca S60000"d77777)) 


The kerne| addresS space 1792099177777 (ASP®S 4,5,64,7) ANd an 
I/a Handler TasKifs (user Space) ~ 107%s503"177777 are 


colnc|dently mapoed, 1,8,, The executivefs tables, lists, 4 
‘Systam Suoroutines, and the extarna|l page ara ayvajlanle to 
Interrupt service routinas (kerne| mode) as well as to a 


Handler?‘s Tasx jeve| coda (yscr mode), 


SAMPLE HANOLER TAS* 


Peaevavevetanrnovaway 


Tne following PO°=11 prosram IS a sample [7/0 Handjer Task ta 
Support ae si{nmgsle unit device egalleg "LF" which oriInts 
G[rectly fron a roquastor’s memory, Tne purnose of thts 
Sample orogranm Js to [Illustrate Handler Task construction, 
and does not represent ostimal coge of a functional wandjer 
Task, Aj! coce unlaue to the da'tice (not presenti|yv an 
exTstent par lpheral) nas oeen omitted, and In many cases 
Fegisters are pedundantly loaded, . 


NOTE e= This sanpila program [s [ncfurted for Tllustrat{an 


Durposes only, It IS axdected trat cuangas (oerrans 
radijcal) w~]f[]| 08 mage a5 YNSangler Task Imp|[ I mentation 
exoer|anca ITs aaltned, This samole wil] be realaceaq Sv an 
actua| |Istijng as soon as possibile, 


Tne orogran Ts used as an examole for tne revalnder of thls 
Specs, 


° . : . e . er i a 
Fee Fase ecoveBwuevwsew@t@g@t@eM®eZwanuwea2vetaeoaseeVEssteaneKtoeveterwwaetvoae aa ws 
- ~ . . PS e o . 


$ GENERAL REGISTER OEFINITIONS 
H Fr 
ROsK2 
R1i=A1 
R2=k2 
R3=sKS 
Rests 
R52%5 
SP=%é 
PCE? 
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es 
} GLOB4L (EXEC) SY4GOL REFERENCES 
i 


~GLOBL 
~CLOBL 
»GLOBL 


4 GLOSL 


°GLOBL 
2GLOBL 
yO OBL 


GLOBE 


»CLOBL 


GLOBE 


. GLOBL 


} 
4 
4 
, -B 
R 
 R 
OR 
oR 
R 
~R 


eGLOBL, 
b 


~CLOBL 
,CLOBL 


HCONMECT INTERRUPT 
JOISCONNECT L‘TCRRUPT 
PNECLARE & SET. 

}CLEAR EVENT FLAG(S) Let 
‘ ;SET EVENT FULAGLS) Lt6 
N89 FIERQUEYE aM 1/70 PEQUEST 
pATTACH UNIT 

SNETACH UNIT 

}170 NONE 

}RTN NGDE TO POOL 

}FLUSN SUCUED 170 REGUESTS 
SRUN=DONS, DONE 


SINTESRUPT SERVICE EXIT 
}IG OF TASK BEING RUNDOWN 


1/0 REQUEST NONE ENTRY DEFINITIONS 


»TGs04 
eRPS56 | 
eLbEL® 


»EF ais 
oF C=? 


2SAz14 


sPASLE 


| 
SB QIRECTIVE PARAMETER BLOCKS (OPES) USE 


TART] 


TASK PIRECTORY ENTRY A408 CREQUESTIR 39) 
PRIORITY - i. 

LoUNTT NUMRE 
pEYENT FLAG SUMRBES 
I/O FUNCTION COQ 
pADDRESS CVIRTUAL) OF REQUESTOR 1/0 STATUS WO9D 
sTEN@WBYTC REGEUST PARAMETER BLOCK 


#OPBL,9(SP) 


11 


FOR INITEAL]ZATI]ON 


7) 
Opi} 101, PSET@SYSTEMSTRAD NIC 
«aa 12 BPWR RECOVESY T8aP 190 
PwRUP jZSERVICE ROUTINE ENTRY 
Ae | 
Opa2: | 421, SSET#SYSTENATPAS CIC 
| 11 B17 RUNGOWN TRAP [9 
: TORUN SSERVICE ROUTINE ENTRY 
1 
} VAIRASBLES YSED FOR INI TIALIZATIO™ 
H 
@ DEVICE 
2 } DEPENDENT 
+) } VASTABLES 
ae | 
BOSTART #© KANDLER TASK ENTRY, AANOLER TS INITIALTZS, 
s AND THE INITIALIZATION CODE IS THEN USED FOR STACK 
 STGRAGE, 
5 
b POWER@RETOVERY & T/O"RUNTOWN SYSTEM TRAP® ARF CONNEOTEA TO 
1 THE SYSTEM VIA "SET SYSTEM TPASM OLRECTIVES, 
- 
$ Mav 


1™q Be we we we we we 


=e SQ we To we ea we GQ we TO 


‘THE HAMDLER TASK IS DECLARED RESIDENT, a4 
~TOENTIFGCATION TABLE (UIT) iS INITIALIZES, 
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EMT . 377 
MOV. . #BOPB2,2(S?) 
EMT $77 


AN INTERRUPT SERVICE ROUTINE IS CONNECTED To TRA? LOCATION 
240, AND THE BASF OF THE SERVICE ROUTINE’S ADDRESS SPACE 


‘IS SPECIFIED AS THE HANOLER TASK¢S VIRTUAL ZERO 


IP THE SERVICE ROUTINE CANNOT BE CONNECTED (ANOTHER 
INTERRUPT SERVICE ROUTINE TS CONNECTED) « THE HANOLER 
TASK EXITS, 


MQV. #240,R2 © STRAP ADR TQ RA 


MOV #INTENT RL FENTRY POLYT TO R4 

CLR sR? {BASE OF ADR SPACE TO R2 
JSR. PCa ,CINT CONNECT | : 
BYC EXIT pEXIT IF NOT CONNECTASLE 


O ITS UIT 


IF NO UNITS FOR THE DEVITE EXIST) ‘THE HANDLER TASH 
DISCONNECTS & EXITS, ian | 


MOV #UIT ARO ie T3L AMR TO RO 


MOV. #1 eR4 fNUMRER OF UNITS TO Ry 
' MOV #"LP,R2  JOEVICE NAME TO RZ 


JSR POr,,OS'T jOECLARE & SET 
BYC DAEXIT a as | 


INITIALIZATION PECULIAR To THE PERIPHERIAL DEVICE 
BEING SUPPORTED IS NOT SHOWN, 


NOP INEVICE 
NOP ; DEPENDENT 
NOP } INITEALI ZATION 


INITIALIZATION COMPLETED -=2 INSTRUCTIONS AMO DATA 
PRECEOINGS THIS LOCATION ARE NO LONGER “EfOSG, THE 
HANDLER TASA'*S STACK IS EXTENDED TI UTILITIZE 
THIS STORAGE, 3 


MOV PC,SP | 
HANDLER TASK JS NOW TOLE AND REACY TO OeeQVeve REQUESTS 


THE HANOLE® TASK/S EXECUTION IS SUSPENDED UNTIL (OP 
WNLESS) 17S EVENT FLAG ONE IS SET, 


THE TASK. WILL REMAIN SUSPENDED UNTIL AN I/O REQUEST 5 
QUEVED FOR ONE OF THE UNITS SERVICED ay THE HANQLEN TASK 
CA UNIT TDENTIFIEO IN THE UIT), 
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PUFA SYSTEM TRAP OCCURS KHILE THE TASK IS “AITING FO? AN 
1 1/0 REQUEST TG SE QUEUEO, THE TRAP SERVICE ROUTINE WILL 
§ SE EXECUTED, BUT THE TASK WILL REMAIN SUSPENDED, 


; , 
IDLE: | 
ra | | : ye 4 
| MOV AWFige(SP) FAALTFOR CF, 41 
ay EMT 377 nes, 
S . 
b TASK EXECUTION HAS RESUMED BECAUSE ITS EVENT FLAS ONE YAS 
} SEEN SET : 
~§ THE EVENT FLAG 1S CLEARED, AND AM ATTEMPT To DE IUEUE ’ 
BoA REQUEST FROM UNIT*2 (THERE IS CNLY ONE UNIT) 23 “ANTES 
3 | | , 
SIF A REGUEST IS DEaQUEYES, IT tS PROCESSEu, IF A 
“fF REQUEST IS NOT Of eQUEUYEO, THE HANOLER SECOMES IDLE, 
DENY 
ees oo | : | , | 
tia *."" SOV VUIT+9,R9 PPUD ENTRY ADR TO RB 
aes . ~ MOV #14yR4 PFLAG IND TQ Rt 
ee a ae POr,sCLEF ICLEAR EF #4 
pero MOV * ULTH+e,R9 PUNT T=#2 PUD ENTRY AQR TO R14 
ie MOV #ANA,RI PRNA GUF ADR TT RY 
. JSR PO~, ,DURQ JOLQUEUE ATTA™PT 
pt BYC IOLE PICLE IF NO CEMQUENE 
+ . . 
F CONTROL 7S OISPATCHED TO APPPOPRIATE SERVICE COOL PER - 
YU/0 FUNCTION COCE, wITY THE RE*YEST NOME ADDRESS is RL, 
} ; 
3 TF THE REQUESTED FUNCTION COOE [5S NOT REroGNIZeD, AN 
$ 1/0 STATS VALUE CF #99 TS RETURNED, 
i 
MOV R,FC(R1L),R2 GSET T7O FUNCTION CODE Ty R2 
: CMP RO, #24554 fWRITE RPESUEST? 
| 360 AM TRES YES we WATTE LIVE 
CMP RK, #1409 INO me ATTACH PECEUITE 
BES ATTPEN BYES 6 ATTACH TF METATHES 
CMP R2,#2004 oNO we DETACH, RONUEST? 
REO DETREN BYES e8 DETATH TF ATTATHES 
CMP R2e#*1777743N0 we PAVOLES EXPT REIVegn? 
REQ EXTREN BYES we FI'TSH SERVICE 6 EXIT 


“OV #n99,,8h29 {NO ee YN ECGGNIEED FUNCTION 
JhP UNSUC 


WRITE PESUEST © THE STARTING ADMRESS ANN LENGTH 
OF THE LINE TO BE WRITTEN ARE VALIOATED, UF OaY, 
THE LING TS PRINTED, IF NOT, Ay T/C STATUS VALUE 
OF 12 1S RETURNED : | 


37 we we we we we we 


RTREQt NOP JVALTOATION YET TO 
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NOP, }BE DETERMINED 
EVENT Fag TWO IS CLEAREO, THE PRINT OPERATION IS 
STARTED, AND EXECUTION IS SUSPEYOED NNTIL EVENT 
FLAG THO 18 SET (GY INTERRUPT SERVICE ROUTINE) | 


Fits GREFERENCE POINT FOR PWR FAIL RECOVERY 


MOV ULT+0,R0 FOLEAR INTERRUPT FLAG. 
“OV R2eRL JFLAG INO TO Rt | 
WSR °° PCa, CLEF fCLCAR EF #2 


ma we — a ie 


NOP SOEVICE 
NOP ; DEPENDENT 
NOP } Cone TO 
“NOP ; START 1/9 
~MOYV gu 2e<(SP) }WAITFOR Bat . #2 
EMT S77 | ke 
F23 SREFERENCE POINT FOR PWR FAIL RcCOVERY 
REQUEST IS FINISHED SY SETTING THE REQUESTORIS. 
1/O STATUS WORD ¢IF SPECIFIED), AND EVENT FLAG 
(IF INDICATED); : . | . 
MBV 2 SEVETS. R: PSUCCESSFUL COMPLETISN? 
BPL SUC —FYES w= RETURN STATUS = +1 
BR UNSUC NO w- RETURN JEVICE sTaTus 


; 

1 ATTREQ. e= UNIT [S ATTACHED 1? RESUESTING TASK (UNLESS 
$ TT TS ALREADY ATTACHED TQ IT), : 
} 
A 


TTREQ! = MoV UlT#o,29 sUNITSA puO ENTRY AOR TO Re 
WSR PCa ATUN ATTACH UNIT 


8VS SNC {IF SUCCESSFUL, SETUN STSs41, 
MOV #034,,R3  JFOTHERWISE, RETUPN STS2-30, 
AR UNSUC 


DETREQ ©= UNIT 15 DETACHED FROM REQUESTING TASK (UNLESS 
; IT 15 “OT ATTACHED), 


DeTREQ! MOV ULT4+d,R3 FUNT T=? PUD ENTRY ADR TQ R14 


JSR POs, eQTUN  JCETACH UNIT 

AVS Suc JUF SUCCESSFUL, SETURN STS=+t, 
MOV #e3N,,83 JOTHERWISE, VETURW STSe-30, 

BR UNSUC 


' EXTREQ «= DANE TASK EXIT REQUEST w= CLEANUP §& EXIT 


EXTREG! NOP SDEVICE 
NOP 3 DEPENDENT 
NOP} CONE TO 
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NOP ; TERMINATE USAGE 


j 
I QECRENCNT REQUESTS PENDING COUNT ANDO RETURN REQUEST “ONE 
i 


ig 


MOV RNA, RS fREQUEST NODE ADR TO RL 
CLR =. R2 JNO OECRENENT ADJ 
MOV #44RS “PSTATUS TQ RB 
JSR PO TOON =f170 DONE 
MOV soa RNA, AY fREQUEST NMOF ADR TO R41 
, JSR = PCg,,8NTP RIN NODE TG POOL 
; . . 
DAEXITE , — FDESCOMNECT & EXIT 
; — Mgy.«g240,R0 =o TTRAP ADR To Rt 
GSR PCy DINT jOTSCONNECT INTERRUPT 
ae : a 
EXITS JEXIT HANDLER TASK 
4 | 


MOV s«454,,8¢SP) FEXIT PIRECTIVE 
EMT = 377 


SUC e+ FINISH SUCCESSFUL REGUEST, I/¢ STATUS IS SET TO +4 
MOV. Heh RE FSET 170 STATUS IN 23 


Cc 
Q 
~ 


—UNSUC #= FINISH UNSUCCESSFUL REQUEST, 23 CONTAINS STavus, 


we we Ge He We Ta Te We 


UNSUCT 
7 MOV RMA, RA  SREQUEST NOOR ADR TO R4 
CLR sR? pNCO CNTS P40 aOy 
JSR PC~,,100N fI70 DN 
} — 7 
MOV RMA RL FREQUEST Nnok ADR To Rt 
JER PCeysRNTP GRTN SOLE TO POOL 
IRNA’ TS CLEARED To -INDICATE "No REQUEST DE-cuEUEO" Ta 
THE T7909 RUNDOWN TRAP SERVICE ROUTING, ~ 
IF AN T/0 RUNDOWN SYSTEM TRAP GCCURRTO WHILE THE 
PRESENT REQUEST “VAS NEWSU EVED, INDICATE 170 SUNe 
OGWN COMPLETE BY RESUMING THE RUNDOW! TASK, 
CLR RNA 
; 
TST ROFLAG 
REQ DEQ 
JSR POp ye RNAN 
‘SR OFQ 
} 


} POWER RECOVERY SYSTEM TRAP wm TF A WRITE WAS STARTED 
J} ANO “OT FINISHED, IT MYST BE REDONE, 
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3 


- 
Sd 
oa) 

I 


PHRUP] “CMP ° @gp,#PF1  yfPF4/ VLE, PC VLE, *PF2t 2 

7 BLT PHREX JNO w= EXIT SYS TRAP 
CMP @SP,#PF2 | ' 
BGT PWREX fNO w~ EXIT SYS TRAP | 
MOV = =s- #PF1,8SP =o FYES w~ CAUSE 179 TG Bk RENONE 
“MOV RA,+¢SP) | 
MOV Rips(SP) 
MOV. ULT+#2,23 
MOV #2,RL 
JSR. PCr, sSTEF FSET ae #e 
"OV (SP) ¥,R1 3 

ane MOV (SP)+,R2 

of eg . 

PWREX § 

aan “MOV axST) © (S?) EXIT SYSTEM TRAP ROUTINE 

EMT 377 
170 RUNDOWN SYSTEM TRAP 

TORUNI MQM RO»=¢SP) 

: MOV BULTHD, RD © | 

Ka JSR PCy, eFLSH FLUSH QUELED REQUESTS 

7 - | 

TST RNA 

BEQ TORR 


MOV RNA, RO 
cmp R’ .TOCROI 4 ROTO 


BNE LOR? 

INC RNFLAG 

BR TORX 
Be! 5 . 
TORR] JSR PCa,eRNDN 
IORX! 
} 

MOV (SP )+,R2 

MOV #XST,= (SP) 

EMT 577 
> 
§ TASK DIRECTIVE PARAMETER BLOCKS 
H 
Wis BYTE 41452 

C0962 
; : 
WR2s sOYTE 44459 

C2 AZ292 
I 
XST3 123, 


{ 
) TASK‘S VARTA8LES 
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J 


RNAS 3 ‘PREQUEST NODE ADDRESS 
ROFLAG} 3 $179 RUNDOWN FLAG 


; 

S HANOLER TASKS UNIT IENTIFICATION TASLE (ONLY ONE UNIT) 
UTS 2 SOUND ENTRY ADR-FOR UNTT#2 

J INTERRUPT SERVICE POUTINE = POSITION INTEPENOENT ROUTING 
yb CRUNS UNTER KERNEL ASAS, WHICH IS SET AT, JR AT CLOSELY - 
f PELOW AS POSSIRLE, THE BASE OF THE [MTT RRUPT SERVICE 

$ ROUTINES ADORESS SPACE AS SPECIFIED WHEN CONNECTED), 


f 
INTENTS NOP ~PDEVICE 


“QP + DEPENDENT 
NOP i INTERRUPT 
NOP } 


SERVICE COOE 
{ SET INTERRUPT FLAG | 
f : as ry ; 
MoV RO,3(SP) 
MOV UIT+5,R@ 

MOMe DY RI bg AS : 

“JSR PO. STEF $SET E£,F% #2 
MOV. (SP)+,R2 a 


ae 
f EXIf INTERRUPT SERVICE ROUTINE 


Hi 
* a JMP ae INTX. : 
“EP x rs = . : * 
OEVSTS! a  JHARDUARE DEVICE STATUS 


j . 
— sEND = START 


e .- - . . . e e . . ait 
VaempeewsgFadae Sevweasasw@#et sa Ve TeSeaea aunt ewoanerweAFtavoeeswetnaeas*X*awrevaeawetiagny @ 
. - o ? @ . 


HANOLER TASK INITIALIZATION 


Handler Task [njtfailzatlon consfsts of connacting to System 
Traps and hardware Interrunt(s), detarmining which 
davicaeun|ts exist (often oniy one and Fow sack Ts 
Tdent{flec, and declaring the Handler Task rasi[dent and abie 
to de=quaya 1/9 faquests, 


T/Q Handler Tasks normally use two Syste Trass, dower 
Feaovory, and [/9) Ffyunda-wn’ Tnese Systan Trans provide a 
means Of jnterrunting a Handiar fask*S normal odaratinn 
whenever Aower Is festored (after a sowar faflure), ara 
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_Whenever a Task EXITS ofr Ts aborted with 1/0 reaques*s 
pendine,. The System Trap service rout[nss are connected to 
tne System (as are al| System Trass) us|ng tne SET SYSTEM 
' TRAP Directive, -; 


‘ 

Most Handler Tasks redu{[re onjy one ‘Jnterrupt servi{se 
-foytine, MNowever, as many as are desired tay exist wi[tnin a 
Handier Task, Connecting an [nterrupt service routine to a 
hardware Intarrunt fs [nstructing the Systan (1) to transfer 
~¢ontrol to an Indlcated service routine whenever an 
Interrupt occurs vfa an |nd{[cated [nterruot trap address, 
and (2) where the hase of the [nterrurt eet yee routinefs 
edaSes space Is ta be sat, a 


’ A System Subrouvlne to connect to an earns Is called as 
“follows; 


RE «= Interrupt trap address, 

Rl -- Entry point of service routines 

R2 -= Base of interrupt Seryj/ce adarass snace, 

R3 -= BIts 2e3’ prescer|]pe tne states of Torultion Todes 
Cy, V, Z & N at entry to Interrupt service routine, | 


JSR PC,,,CINT 


When the connect Js successful, CCeV (Condition Code "V") Is 
‘SET ueton sudnroutine. return) if unsuccessful, CCev Is CLEAR 
- upon returr, : 


In most cases, when an I[ntersupt service routine cannet he 

connocted, the Hand|er Task cannot run, and It sinniy SXITs, 
However, t%e Handjer Task can be caded to do wnatever Is 
aporoprljate, 


In tne sample oroqram, the fnterritpt service routine 
teferences tne "Ninft Identifileation Tabje" (UIT), but no 
Other part of tne Tas«x« outsf[da of tre Interrupt service 
Foutine, Hance, tha base of the [nturrunt service routire 
Goy|d Mave bean sat as High as fUIT" It IS set at the 
Task*’s virtual zero to Snow that: "Unisss a nanalar Task Is 
Yarser than 4K words, Interrupt service rout{[ne references 
do not restrict Hand{er Task jayout"; 


When contro| js transferred to an [nterrupt servica routine, 
ASRS Is set as close ta the spacifiedr “basa of Jnterrunt 
Servi[ce address space" without excluding Jt, %1,@,, virtual 
Tocatlon 7647399 ex[sts at a S2eword oound at Of befow tia 
focatjon |[ndlcatad In R2, 


Aj| trandjer Tasks previde spaca for a systomeset “init 
Idant(f|cat{on Tahlie", Tats table consists of Nne*word 
entries for sach devicaerun{[t that tre Hanaler Task can 
Sery]ca, words representing noneexistert units (no PUD 
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entry) are set to zero, Words representing existing unlts 
@re seat to the coreasnonding PUD entry adaressos, These 
-addresses are nmormalfy used only as un[t f{dentiflers whan 
Mak[ng requests of System Subroytiness however, tney also 
Dravide an access to a unitis PUD entry, which Is useful fn 
Some snec{a| cases, . 


A System Subroytina to Initlattze thls table and declare thea 
Hand/er Task resident and ready to deequeye requests [Ss 
EEE as follows} 


RG =e Device name (two ASCII characters)» 
RL oe Maxfmym number of uni es (t#ol}e size), 


JSR PCy DSUT 


If at least one PUN entry fok the specifled device {[s found, 
CCeV {fs SET upon Subroutine ee If the device name Is 
not found [nm the PUN, CC-V fs LEAR ynon ratiurn, The 
Handler Task |{s flagged res{dant [n tne PUD entry for aaah 
un{t ie to the Handler Task, - 


TOLLE STATE FOR HANDLER TASKS 


Sewn wen sewer e dacs naeweenne 


When a Handier Task Ts {dje, [t suspends [ts execution unt] 
an 1/0 fequast is queued for a unit Suoported by [t, This 
Ts dona by jssuing a wWAITFOR Ofrect|ve, The Handler Task’s 
Event Flag ones |s set whenever a roquest {S, queued for one 
of its unfts, Normally the WAITFOR DOYWR Indjeates Event Flag 
Range 1-16, and fjag numbet one, however, In soma cases [t 
may be deslradie (and |s possible) to walt for mora than one 
Event Flag’s setting, | 


If a Power Recovery or a@ [T/0 Rundown System Trap occurs — 
walle &a handler Task {s [dle, the Task wif! remain sussxanded 
unjoss the System Trae | service Foutine cased {ts 
Fesumption, | ; 


1/0 REQUEST PROCESSING 


‘ a o . . ° ‘ . 
Leerssen svvawavewe tae 


When an Tdle Handler YTaSkfs executfon Is rasumed tas a 
fesuj{t of IJts Event Flag one being set) {% normally clears 
that Flag befopa attemotins to deetueue a F?Faquest, [3] 
however, [nm some speclal cases {[t }s doslrabi{e to clear the 
Queue Flag (Event Flag one) at other times, 


Tne CLEAR EVENT FLAG O{[rect{ve could-’be ysed, howaver, STnce 
the Priv{leged Task has access to the systenfs |[sts, a 
System Suoroutina [mposes less overhead (and can clear nore 
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‘than. one flag), A Subroutine to clear. any of a Handler 
Task‘s Event Flags ‘1216 |s called as foj lows}. 


RO se PUD entry address (from UIT). 
RL s= Flags [nd[cator, © 


JSR PCa, ChEF | , 
Ri by ts G-15 represent Event Flags 1-16 respectively’ 


“1/0 wequests for an Tndlcated unlt are deequeued by using a 
$ubFOoUut{[ne to attempt to de-queue a request node, This 
Subroutine |[s called as follows; _ 


RO se PUD Entry address (from UIT), 
RL se Address of buffer for "RNA", 


VSR PCy, DRA 


If this subroutine Ts caljed and the request |ist for 
Indicated unit Is empty, a request node Js not deequeuad fof 
oyurse). Also, even when a freauest [ist |s not empty, It Is 
possible to NOT be able to de-queus a request because (4) 
the wnit [S ATTACHead and no requests for the attaching Task 
are Jn the |[st, and/or ¢2) requests |nA the ||St have bean 
Made by a Task that [s checkpointed, 7 


When a request |s desqueuyed, the Request Node Address (RNA) 
Ys storeq In the ouffer Indi[cated In Ri, a “Requests In 
Pracess Count" [s  |ncremented,C6] and cCC-V js SET sponn 
Subroutine peturn, When a request [s NOT desqueyed, CC=Vv Is 
CLEAR upon subroutine return, 


When a pequest node [8s de~queued, [ts address [Ss set [n the 
Callilng programés buffer (nor RL) wiltn Interrunts |nn[ol ted, 
ThIs |S done so that a nonezero RNA buffer can be used as a 
"paquest deésqueued" flag, , 


s s = o e + 
‘RPeveeretvaeunauwreon 
“ - ‘ . - « . 


£53 To avold the race cond{[tlon that ex]}sts whan aie soecand 
Fequest {Ss queyed just after ai fajllure to de#-quauea has 
Caysed the Handjer Task to become |d/e agaln;, 


e ¢ ° t e 
‘Pease usanvcasaere 
o7 _ - “fs . 


C61 If WNNo Return” fynetfon, Reqyests [n Progress Count Is 
NOT Incremented, 
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The Requests [n Process Count Is a byte Tn the ATL node of 
eyery active Task, This count [s Inceramentad whensaver a 
fequest for tne Task Js de=quaued, and decrenented whenever 
R request for the Yask Ts csompfeted,£7] It prov{[des an 
Indication of raauests belng procassad, and Is used to delay 
the record|ng (Swapo|ng-out) of a checkoo|nted Task unt] | 
¥/0 In process nas been complsted, 


Nopmally after de-queufng a feaquest, the 1/0 Functlon Code 
Ys exanined, and contro! |s transferred to a routine to 
Perform the Indicated function, tf the function I[s not 
Pecognized by tha Hand{er Task, a status of 99 (by 
Convention) [Ss petyrned, - , 


tf an ATTACH reqyast Js de-queued, and the unit I[s not 
elpeady attached (to the prequyest{[no Task), the unit Is 
flagged for the exciysive use of the attaching Task; thls 
GCayses tne PDarqueue Request System Syoroutina a let, to 
only gereuene raguests for that Task’ 


A System ‘Subroutine to attach a yn{t —s eal ied as fol towss 


RB s@ PUD entry addrass (from UIT) 4 
RL se Request node address, 


VSR PCy VATUN 
When a un{t Is attached, Cte fs SET upon Subroutine return, 
When auni[t Is NOT attached, CC-V Js CLEAR upon return, 


Yf a GETACH request {8s de-ausued, and the unit Is attached 
€¥o tne requesting Task, the ATTACH [s nulllffed.. This 
Cayses tha Dewaueue Request System Subpout[ne {,,0GR9) to 
Geequeue fpom the top (High priority) of the unit's request 
Tihst, | 

A system Subrout{[na to detach from a unlt [3s called as 
fo} jows] | | 


RB == PUD entey address {from UIT), 
Ri 2e- Request node address, 


JSR Poa: sDTUN 


When a unit Ts detached, CCV Is SET upon subroutine return, 
When a un[t {s NOT detached, CC-V Is CLEAR yoon roturn, 


o « « ° a 
Fewvrwteecenernvese 
= rep moe ~~ = 


’ 


C73 Uniess "No Return" funetton, 
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Many 1/0 requests require a transfer elther to op from a 
PequeStor/S memory, The ange of treSe transfers muSt be 
‘validated [n order to malntaln system Integelty, The 
foflowing three subroutines ald Tn th[S operation, 


\ 
A System Subroutine to valifdate a transfer and setup: an 
L&ab}t starting address (for a perlpnerltal contrpolior) Ts 
¢alled as follows} 


R2 s+ First word addrpass (user virtual): 
R3 == Transfer Jength (Tn bytes), 


MSR Pay VXER 


Vf the transfer Ts Invalid, CC=V Ts CLEAR -upon subroutine 
Return, lf the transfer Ts valld, CO=V 18 SET upon return, 
and the 48=bp]/t starpti[na address [s Tn R4 & RS; Tha ow 
Order 16 b[ts are In R5, and the Aigh order two b]ts are Tn 
bits > & 4 of R4 with all other R4 b[ts olaeared, 


-‘Systen Subroutines to validate a transfor, and |f valltd 
Perform the transfer, are called as fo! lows} 


 R2 Se First word address (user virtuale 
- RS s= Transfer Jangth (nm words), 
— R4 ee Memory buffer address) - 


WSR PCy 1 yBLX! rag: Sranater ING 
- or 
“JSR PC,,,8L%0 For transfer OUT, 


T¢ the transfer IS parformad, CCsy [s SET upon subdrouting 
Paturn, If the tgansfer [8S NOT perforned, CC#V [s CLEAR 
“Upon raturn, 


Wren an 1/0 operatyfon [8S compi|ated, an Event Flaq and an [/0 
Status Word may be set (If Ind[cated |n rpanuest nodad,y the 
Pequest[ng Taskis !/0 Pending Coynt [S usually decremented, 
and |Jts Reauests -In Prograss Count [s decremented, € 


A System Subroutine to finish an 1/0 pequest |s caljed as 
follows} 


Ri #= Request node address, 

R2 == Adjustment to unlty decrement, 
RS w= 1/0. Status Block Wd, G6, 

R4 e~ [1/0 Status Block Wd, 34, 


C8) If "No Return" funetlon, NETTHER ooynt [8s altorad, 
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WSR PCy, [OOM 


it an 1/0 Status Block address was spec{fled In the ‘pequeat 
mode, the Status olock (In the pequestor!s memory) |]s set to 
the eontents of RS & R4, 


“1¢ an Event Flag nymeor was eer ee In the request peda 
that event flag [s set and a Slanifleant Event Is declared’ 


Tne 170 Retuests Panding Count for tne reaquest|]mg Task Is 
seoremeantsed and then modl¢led by addfina the econtants of R2 
to |%, R2 [8s normaly Zero, however In Some casas the 
deorement(|ng may be adjusted (vlz,, R2s*l for FILE OPEN and 
R2zsei for FILE CLOSE), The ATTACH 4% ODETACH subroutines 
med|fy a faskis ]J/0 panding count so that a reauest Js 
—Gons| dered panding whjie a yait [s attached to that Task} 


When an 1/0 request mode [s no jonger meeded by a Handjer 
Task, [t'[S returned ta the poo] of avafiabje {Ist elements, 
A System Subroutina to return a mode va the poo| fs called 
a8 fojlowsi 


RL ee Request node atacoeee* 
MSR PGi eRNTP | 


When an 140 operatfTon [8s Started whose tarmi|nat{[on IJs- 
Sienaled ety a Aardware interrunt, the Handler Task may use 
tne WATTFOR INTERRUPT Dlreective to susnend [ts execution 
Unt{] the [Interrupt (or aporopelate serlas af Interrupts) 
has occurred, Norpmaljy the Kandiar Task!is Event Flaq twa 
(2) {8 used as an “"[nterrust fiag’, This flag 18 normaj ly 
ejearad befors starting an onarati[on and set by an I[ntareunt 
Service routina to sf{gnal completion; 


A Subrout(ne to clear any of a Handjer fTaskis Event Flags. 
iei6 [s called as fojlews} | 


R® ee PUD entry address (from UIT), 
Ri ee Flags |[nd{cator, 


| JSR PCa, CLEP , 
R4 bits Gei5 represant Event Flags i216 rpaespoct}valy, 


A Subrout]me to sat any of a Handler Tasks Eyant Flags {=16 | 
Ts cajled ag fojysows} 


RO ee PUD entry address (from UIT), 
Ri e= Flags |nd]cator, 


JSR PC,, STEF 
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Ri wisi ag represent Event Flags 1e16 pespactlyely; 


HANOLER TASK EXIT 


Gecrrerssesrreens 


Yhe UNLOAD MCR FunctTon [IS used to cauSe a-a Handljer Task to 
exTt, This Ts done by queying a jow orlority request to the 
unTt rpepraSentad by the device/s flrst PUD entry, and 
Inkl biting furthurz aueulng by declaring the Handiar Task 
Aonsres|dent (In each PUD entry), The J/0 function code for 
an ex{[t request [1s 177771 foetal). Gs 


In most sIneleeyun|[t devices, eeivieine an ex}]* peaquyest 
cons Tsts of finishing the request (¢(,,J00N & {4,RNTPI, 
d}sconnecting from hardware Tnterrunts, and EXITI ng; More 
comp'|ex Handler Tasks require add{[tlonaj] code to process al| 
‘aueyed rpaquests before EXITing, 


WhT |e a Handler Task Js [n the process of EXITIng, }t cannot 
be resloaded (the LOAD MCR Funet]on wii find |% active); 


1/0 RUNDOWS.. 


Eeesescoiue 


‘When a Task EXITS or |[s aborted w[th 1/0 requests pendina, 
the Task |s considered active (ATL node and merory stf{l| 
ex][st) but not runable, and a pequest to "Pundown" Its J/0 
Ts made (¢yla SEND & REQUEST Direct|ve) to a Task called 


The 1/0 Rundown Tasks pequests Handler Tasks to flush queued 
Peauests and eltner finish or abort amy peqgiuests Jn process 
for an |nd[cated TaSk, by (4) clearing |ts Event Fijaqg ona, 
(2) placi]ng the Task!s STL node. address In thea SCOM word 
“ROTO, (3) causing an 1/0 Rundown System Trap for a 
Partiloujar Handlorp Task, and (4) suSpend|ng {ts execution 
Until] [ts Event Fiag one |s set, 


When the Handler Task completes Tts 1/0 rundown Servica, It 
Pesumes the execut{on of the 1/0 rundown Task by setting [ts 
Eyent Flag one, 


A System Subroutine to set Event Flag one of a Task called 
m430,," [s called as follows} 


JSR PCy’, RNDN 


‘Tne 1/0 Rundown Task continues thIs process until! alther the 
Requests Pendina Count for thea Task bhelng rundown I5 
Goaremanted to zaro, or al| devices have been scanned (In 
which, ¢ase something |s wrong, |Tkely a bad handler); 
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A System Subroutine to flush alt requests from a devices 
¥Yequest |[st for tke Task on which 170 os dbelng pundown (per 
SGOM) Is cajied as fajlows! 


R@ es PUD entry address (from UIT); 
JSR PCsy.FLSH 


POWER “FAILURE RECOVERY 


When the systom recovers from ai power fallure, a Power 
Recovery System Trap {8s generated for ajl| Tasks that are 


/ Setup to saryice the trac, 


770 Hand|er Tasks are coded to do what ever Is necessary to 
Pecover, . [In some cases, thTs Is simply repeating a reaguect 
Tf a request was being processed, viz,, Hagtane read, tn 
Other casos, recovery I[s detarmined by tha degres cf 
completion at power faflurea, Vizws If power falls during a 
Magtape write, the Handjos Task must detarmine wheather 
anything was wrltten and condit{onal|y backspace bafore 
 PeewFR[ tag, 


